﻿biomass {}                               R Documentation

		Função para calcular a biomassa acima do solo de árvores e palmeiras de folrestas tropicais 

Description:

     A função usa equações alompetricas desenvolvidas apartir de um modelos de regressão linear, a proposta é que o usuário possa escolher as diferentes
equações apartir do DAP, podendo incluir dados de Altura e de Densidade da madeira

Usage:

     biomass= function (Dap, Alt=NULL, Dens=NULL, CAP=FALSE, Methods = c("Arv.DAP","Arv.DAP.Alt", " Arv.DAP.Alt.Dens", "palm.DAP", "palm.DAP.Alt"), grafico = FALSE)
Arguments:

 Dap: Vetor de valores de Diametro a Altura do peito em cm
 Alt: (opicional) Vetor de valores de Diametro a Altura do peito em m
 Dens: (Opicional) Vetor de valores de Diametro a Altura do peito em g/cm³
 CAP: Argumento lógico que permite a conversão dos dados do primeiro argumento de CAP (Circunferencia à altura do peito) para DAP
 Methods: vetor com as diferentes equações alométricas da função
	Arv.DAP: Equação Alométrica "Biomassa= exp(α+β1 ln(DBH)+β2 (ln(DBH))²– β3*(ln(DBH))³) "
	Arv.DAP.Alt: Equação Alométrica "Biomassa=exp(α+β1*(ln(DBH)²*H))"
	Arv.DAP.Alt.Dens: Equação Alométrica "ρ*exp(α+ln(ρ*DBH2* H)"
	palm.DAP: Equação Alométrica "Biomassa= α + (β1(DBH^0.5)*ln(DBH))"
	palm.DAP.Alt: Equação Alométrica "Biomassa=exp (α+β1 ln(1/(DBH)²)+β2ln(Height))"
grafico: Argumento lógico para plotar um gráfico de dispersão de DAP por Biomassa acima do solo 
 

Details:

     A função utiliza equações para serem usadas em dados de árvores de florestas tropicais, as equações são baseadas em modelos de regressão linear e dados de métodos destrutivos de estimação de biomassa acima do solo. Para mais informações ler Vieira et al (2008)

Value:

     Função retorna valores em kg
Warning:

     Tenha atenção às unidades dos dados inseridos, caso não estejam padronizadas.


Author(s):

     Pedro Rufino MARTINS

References:

	1 Vieira et al. (2008) Estimation of biomass and carbon stocks: the case of the Atlantic Forest, Biota Neotropica,2 (10), 21-29
	2 Chaves et al. (2005) Tree allometry and improved estimation of carbon stocks and balance in tropical forests, Oecologia, (145), 87-99
	3 Chambers et al. (2001) Tree damage, allometric relationships, and above-graound net primary production in central Amazon forest, Forest Ecology and Management, (152), 73-84 	
	4 Saldarriaga et al. (1988)LONG-TERM CHRONOSEQUENCE OF FOREST SUCCESSION IN THE UPPER RIO NEGRO OF COLOMBIA AND VENEZUELA, Journal of Ecology, (76), 938-958 
	5 Brow et al. (1989) Biomass Estimation Methods for Tropical Forest with Applications of Forest Inventory Data, 4 (35), 881-902 

See Also:

	AGBmonteCarlo; computeAGB


Examples:
	Dap= sample(abs(runif(20, 15, 30)), 10)
	Alt = sample(abs(runif(20, 1.5,20)),10)
	Alt2 = sample(abs(runif(20, 1.5,20)),5)

	#caso só tenha dados de DAP
	biomass (Dap,  Methods="Arv.DAP")

	#caso tenha dados de Altura
	biomass (Dap, Alt, Methods="Arv.DAP.Alt")

	#se os dados não tiverem comprimentos iguais
	biomass (Dap, Alt2, Methods="Arv.DAP.Alt")
	
	#Para a função
	Error in biomass(Dap, Alte, Methods = "Arv.DAP.Alt") : 
  	comprimento das variáveis DAP e ALTURA não são iguais


	#se ouver dados nulos

	biomass (Dap, Methods="Arv.DAP.Alt")
	
	#Para a Função

	Error in biomass(Dap, Methods = "Arv.DAP.Alt") : Dados de Altura Nulo






